home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_util / cidtool2.zip / CIDTOOL.DOC < prev    next >
Text File  |  1996-06-01  |  8KB  |  209 lines
  1. CID ToolBox 2.01 Documentations
  2. ───────────────────────────────
  3.  
  4. 1.  What is it?
  5. ───────────────
  6.  
  7.     CID ToolBox is a CHEAP yet effective utility I created for any
  8. Telegard 3.0 (and any gamma version) BBS.  At first I created this utility
  9. only to be used by me, but seeing how popular caller-ID security has become,
  10. I decided to let the rest of you enjoy the security I've enjoyed for the
  11. last few years. :)
  12.  
  13.     This version of CID ToolBox is an enhancement of version 1.3.  Please
  14. read the WHATSNEW.TXT file for more information about what is new in this
  15. version.
  16.  
  17.  
  18. 2.   Features
  19. ─────────────
  20.  
  21.     What CID ToolBox does is as follows: (In order)
  22.  
  23. 2.1  New Users
  24. ──────────────
  25. - Shows the user their current name / Data number / Voice number
  26. - Takes their phone numbers from the BBS and compares it to that of what
  27.   the CID program detected.
  28. - If the DATA number matches, the user gets validated to level B (you can
  29.   change that in the script file)
  30. - If only the VOICE number matches, a user is given a notice, and is left
  31.   as unvalidated until the DATA numbers match.
  32. - If none of the numbers match, the user is validated to level D, and the
  33.   system hangs up on him.
  34.   NOTE: Level D is the same as level A, except that you should set it so
  35.         that it expires in 1 day to Delete.  This allows the user to call
  36.         back, this time giving the correct information in 48 hours.
  37.  
  38. 2.2  Regular Users
  39. ──────────────────
  40.  
  41. - Does everything as above, with the addition of the following features:
  42.  
  43.   - hangs up on users using the same phone number as another user.
  44.   - hangs up on users if the data number doesn't match, AFTER the user had
  45.     a chance to write a message to the sysop.
  46.   - hangs up on users whose phone number couldn't be detected by the call
  47.     display program. (Call blocking, LD - UNKNOWN NUMBER, etc.)
  48.  
  49.  
  50. 3.   What do I need?
  51. ────────────────────
  52.  
  53.  CID ToolBox it self is written :  45% in Turing (Hence the size of the EXE)
  54.                                     5% in Batch
  55.                                    50% in Telegard 3.0 script
  56.  
  57.     so you can see what kind of bad programmer I am. :)  To get CID to work
  58. for you, you will require the following:
  59.  
  60. - Telegard 3.0 (NO, it will not work with Renegade, so forget it!)
  61. - a Caller-ID capable modem. (ie. Supra or the new USR Robotics Couriers)
  62. - CID enabled from Bell. (It costs me 5$ / month)
  63. - CallDisplay 2.50 + (at release, the newest version is 2.52)
  64. - 2 minutes of your time to get it to work.
  65.  
  66. 3.1  About CallDisplay
  67. ──────────────────────
  68.  
  69.         Call Display is a utility written by Jon Fletcher of the Lava Rock
  70. BBS. You can contact his BBS at (905)566-8518. This utility basically works
  71. between your front end (like Front Door) and Telegard. What it does is simply
  72. capture the incoming phone number from your CID capable modem and outputs
  73. it to your users along with their Alias/Real name after checking it with
  74. the user list.  It is a great program, and costs about 20$CDN to register.
  75. It's a must for this utility to work since this utility reads CallDisplay's
  76. log file and compares the user's phone number to that of what is in the log
  77. and acts accordingly.
  78.  
  79.          More documentation is available with CallDisplay.
  80.  
  81. 4.  How to install it
  82. ─────────────────────
  83.  
  84.         Basically, to get CID ToolBox to work, do the following:
  85.  
  86. 1) Create a new directory for it, and put all the files there.
  87.    (for example, make the directory C:\CIDTOOL and unzip this archive
  88.    into that directory)
  89.  
  90. 2) In TG 3.0 there are 2 things which a USER goes through before reaching
  91.    the main menu.  The first is LOGON.SCR, the second is a menu. (LOGON.MNU)
  92.    Go into the setup of TG, and under LOGON -> LOGON MENU notice the login
  93.    menu which is set. After this, go into the menu editor and edit that
  94.    menu, adding the following entries into it (before anything else).
  95.    NOTE : You can add this to the script, by high access users can bypass
  96.           the script VIA fast login.  They can't bypass the login menu
  97.           via the fast login. :)
  98.           Also, remember the key for all commands should be: FIRSTCMD
  99.  
  100. 1)          Command : -E
  101.             Options : precid.scr
  102.             Access  : N1
  103.             (Will work only on node 1, if you have N2 as local)
  104.  
  105. 2)          Command : D-
  106.             Options : c:\telegard\cidtool.bat
  107.             Access  : N1
  108.  
  109. 3)          Command : -E
  110.             Options : cidtool.scr
  111.             Access  : N1&s50 (validated user access)
  112.  
  113. 4)          Command : -E
  114.             Options : cidtool1.scr
  115.             Access  : N1&s20 (nonvalidated user access)
  116.  
  117. NOTE : I have it set on my system so that only users calling the system
  118.        see the utility. (why would you want it locally??)  So if you have 2
  119.        nodes, change the N1 -> N1|N2
  120.  
  121.        Also, CIDTOOL.SCR is for regular users, CIDTOOL1.SCR is for new, non
  122.        validated users. DO NOT get the 2 mixed up!
  123.  
  124. 3) Edit CIDTOOL.SCR, CIDTOOL1.SCR, PRECID.SCR and CIDTOOL.BAT and make sure
  125.    you have all the paths are set correctly.  In CIDTOOL.SCR and CIDTOOL1.SCR
  126.    the users has the option of sending a message to the system if they fail
  127.    to access the system.  Make sure you change the name from "Sysop" to YOUR
  128.    name.
  129.    NOTE : Place ALL the script files in your TEXT directory, and the BATCH
  130.           file in the main TG directory.
  131.  
  132. 4) Edit your CALLDISPLAY setup and make sure that the BBS LOG file is set to
  133.    point to the CID ToolBox directory, and that the file name of the log file
  134.    is CALLCHK.CID
  135.  
  136. NOTE : The log file gets killed everytime by CID ToolBox. But fear not, the
  137.        c:\callchk.d1 file is still there!
  138.        The reason why the program feeds off the log file and not the drop file
  139.        is because the LOG file is much more stable.
  140.  
  141. 5) Edit the batch file that starts Telegard. At the end, after TG quits
  142.    back to front door, add the following line:
  143.  
  144.                             DEL C:\CIDTOOL\CALLCHK.CID
  145.  
  146.    This will stop bad log files from getting in the way of the program.
  147.  
  148. 6)  In Telegard, under the user levels, make sure the following are set
  149.     (or at least make it so, if not)
  150.     Level A : This is the unvalidated level
  151.     Level B : This is the validated level
  152.     Level D : This is the unvalidated level with expiration set to 1 day
  153.               at which point the user is DELETED
  154.  
  155.     Note : On my system, Level C is high access user.
  156.  
  157. 7)  Edit the CIDTOOL.CFG file and read the docs on the bottom on
  158.     how to set the program.
  159.  
  160. 8)  Edit the DONTSCAN.DAT file and read the rules there and set it up
  161.     accordignly.
  162.  
  163. That's it!
  164.  
  165. 5.  How it works
  166. ────────────────
  167.  
  168. PRECID.SCR - This creates a temporary drop file which contains the users
  169.              real name, user ID, data phone number and voice number.
  170.  
  171. CIDTOOL.BAT - Starts the CIDTOOL.EXE file, and deletes any files left behind
  172.               by the program.
  173.  
  174. CIDTOOL.EXE - This is 1/2 the program. It reads the drop file, and searches
  175.               the log for the phone number. If the number is found, it
  176.               creates a report file, if it's not, it appends to the log file.
  177.  
  178.               NEW in 2.0 : The program is now more advanced and does a LOT
  179.               of work now.  Read the CIDTOOL.CFG and DONTSCAN.DAT file for
  180.               more info.
  181.  
  182. CIDTOOL1.SCR - This is for new users. It handles the user screens, and such
  183.                as well as upgrades users to level B.
  184.  
  185. CIDTOOL.SCR - Same as above, except for regular users.
  186.  
  187. 6.  Final Words..
  188. ─────────────────
  189.  
  190.         CID ToolBox is FREE. And as such has no guarantee whatsoever, if it
  191. screws up your computer, too bad (Don't worry, it will not!) If you wish, I
  192. can give you the code for it, and you can write your own engine in C++ or
  193. whatever else you wish.  Remember, I use this already for a year now, and it
  194. works great, so why not enjoy the security of Caller-ID?
  195.  
  196.                                                    Enjoy,
  197.  
  198.                                                    Leon Kiriliuk
  199.  
  200.  
  201. Contacts:
  202.  
  203. EMAIL : leon@sns.gryn.org
  204. BBS   : The Sight & Sound BBS
  205.         416-665-6908
  206. FIDO  : 1:259/532
  207. TNC   : 20:23/504
  208.  
  209.